home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 January / EnigmA AMIGA RUN 14 (1997)(G.R. Edizioni)(IT)[!][issue 1997-01][PLANET CD IV].iso / planetkit / amiga / planetexec / irc / amirc.doc < prev    next >
Text File  |  1996-12-23  |  75KB  |  2,441 lines
  1.  
  2.  
  3. AmIRC
  4. *****
  5.  
  6. Welcome to AmIRC, the AmigaOS IRC client.
  7.  
  8. Copyright
  9. *********
  10.  
  11. Copyright
  12. =========
  13.  
  14. AmIRC has been designed, developed and written by
  15.  
  16.          Oliver Wagner
  17.      Landsberge 5
  18.      45549 Sprockhövel
  19.      Germany
  20.      E-Mail: (owagner@lsd.wupper.de)
  21.      
  22.      
  23.      All Rights Reserved.
  24.      
  25.      This document compiled by Laurence Walton (lww@pgh.net)
  26.      ©1996 Oliver Wagner
  27.      All Rights Reserved
  28.      
  29.      Installer Script
  30.      ©1995,1996 Robert C. Reiswig
  31.      All Rights Reserved
  32.      
  33.      No part of this archive may be redistributed except with the entire
  34.      contents of the original archive.
  35.  
  36. Registering AmIRC
  37. *****************
  38.  
  39. License
  40. =======
  41.  
  42. AmIRC 1.1 Registered Software License Agreement
  43. ----------------------------------------------
  44. AmIRC 1.1 is Copyright © 1996 by Oliver Wagner, All Rights Reserved.
  45. The producer of this software will grant the Licensee a limited,
  46. non-exclusive right to use the program AmIRC 1.1 and it's associated
  47. files on a single machine. The producer will hand out a special
  48. identification file called the key file to the Licensee. This key file
  49. will enable the Licensee to fully use the AmIRC 1.1 package according
  50. to the terms of this license.  The key file is stricly for personal use
  51. by the Licensee only. Any disclosure of they key file will invalidate
  52. the license and the key file itself. The Licensee will be held liable
  53. of any damage arising out of the disclosure of the key file.  The
  54. product is provided as is without warranty of any kind, either express
  55. or implied, statutory or otherwise, including without limitation any
  56. implied warranties of non-infringement, merchantability and fitness for
  57. a particular purpose. The entire risk as to use, results and
  58. performance of the product is assumed by you and should the product
  59. prove to be defective, you assume the entire cost of all necessary
  60. servicing, repair or other remediation.  In no event shall the producer
  61. of this product or it's resellers be liable for any property damage,
  62. personal injury, loss of use or other indirect, incidental or
  63. consequential damages, including without limitation, any damages for
  64. lost profits, business interruption or data which may be lost or
  65. rendered inaccurate, even if we have been advised of the possibility of
  66. such damages.  This agreement shall exclusively be governed by the laws
  67. of the Federal Republic of Germany.
  68.  
  69. Registration
  70. ============
  71.  
  72. If you have not registered for AmIRC, it will prompt you to do so upon
  73. startup. Registration at the US site requires $25.00 in US funds for
  74. an emailed keyfile, or $30.00 for a disk mailed via postal service.
  75. The Germany Site requires 35,-DM for an emailed keyfile and 40,-DM for
  76. a floppy sent via postal service.
  77.  
  78. What is IRC, by the way?
  79. ************************
  80.  
  81. Introduction
  82. ============
  83.  
  84. IRC stands for Internet Relay Chat, written by Jarkko Oikarinen
  85. (jto@tolsun.oulu.fi).  In a nutshell, IRC consists of a network of
  86. computers (servers) that are connected to each other via the internet
  87. or a LAN, and allow users with proper client software to connect and
  88. chat with each other.  Within this network, virtual space is divided up
  89. into channels, usually with a topic of conversation, where users can
  90. talk in groups.
  91.  
  92. #amiga
  93. ======
  94.  
  95. If you are reading this, you are most likely using one of the
  96. Requirements family of computers (if you are not, BUY ONE! :), and will
  97. likely want to check out #amiga on IRC.  #amiga is one of the most
  98. populated channels of IRC, with an average of 30 to 60 users on at any
  99. given time. #amiga is often visited by amiga hardware and software
  100. developers, and is sometimes a forum for formal discussions held by
  101. dignitaries from software/hardware development companies.
  102.  
  103. #amiga Etiquette
  104. ----------------
  105.  
  106. There is a sort of an unwritten code of conduct for IRC, and especially
  107. #amiga.  This section is included so that you dont find yourself
  108. /kicked or /banned and dont understand why.
  109.  
  110. DO's
  111. ----
  112.  
  113.     DO:
  114.  
  115.      Enjoy your visit to #amiga
  116.      
  117.      Offer to help someone IF you know what your talking about.
  118.      
  119.      Be polite to other users.
  120.  
  121. DON'T's
  122. -------
  123.  
  124.     DON'T:
  125.  
  126.      Ask questions about software/hardware problems without reading the
  127.      manual first (RTFM!).
  128.      
  129.      Ask a question more than once. If someone can help you, they will.
  130.      
  131.      Ask for latest amiga news or info on new software, see newsgroup
  132.      comp.sys.amiga.announce for this.
  133.      
  134.      Ask for OPs.  You won't get it.
  135.      
  136.      Pound or slam Amigas.  If you don't like them, don't /join #amiga.
  137.      
  138.      Pound or slam Amiga Software (the coders might be there :)
  139.      
  140.      Offer to help a user with a problem if you don't understand it
  141.      yourself.
  142.      
  143.      Offer or ask for commercial software or the keys to activate
  144.      demos.
  145.      
  146.      Plug developers who appear from time to time with questions and bug
  147.      reports, use the proper channels for this (i/e, the developer's support
  148.      address).  Note that you might ask first if they are willing to discuss
  149.      problems/bugs with their product.
  150.  
  151. Terms You Might Encounter
  152. *************************
  153.  
  154. IRC Terms
  155. =========
  156.  
  157. #amiga
  158.      IRC Channel on Efnet and Undernet for users interested in the
  159.      Amiga family of Computers.
  160.  
  161. Action
  162.          CTCP Action command, executed by a /me at the beginning of a
  163.      message.
  164.  
  165. ARCnet
  166.      Amiga Relay Chat Network. Served by several Amigas running
  167.      CLChatServer, forming a small network used by those interested in
  168.      the Amiga Family of Computers.
  169.  
  170. Ban
  171.      A channel mode set in order to prevent a user or group of users
  172.      from joining a channel.
  173.  
  174. Bot
  175.      Short for Robot, a Bot is a script that acts like a user, and
  176.      can execute a command upon a certain occurance.
  177.  
  178. Client
  179.      Software that is written for the purpose of connecting to a
  180.      server, in this case, an IRC server.
  181.  
  182. Channel
  183.      A group of users on IRC. A channel will have a name (i/e,
  184.      #amiga), and may or may not have a topic of conversation.
  185.  
  186. Channel Mode
  187.      The properties of a channel that allow or disallow certain
  188.      activities.  Channel Modes can only be changed or set by
  189.      Channel Operators.
  190.  
  191.     Invite Only
  192.           If active, This mode allows users to join if they have been
  193.           invited by someone in the channel.
  194.  
  195.     Private
  196.           If active, the channel is invisible in the global channel
  197.           list.
  198.  
  199.     Limit
  200.           If active, Sets a limit on the number of users allowed to
  201.           join a channel.
  202.  
  203.     Moderated
  204.           If active, only Channel Operators and users with
  205.           voice may type input to the channel.
  206.  
  207.     No Messaging
  208.           If active, prevents users from sending a message to the
  209.           channel until they have joined it.
  210.  
  211.     Secret
  212.           If active, the channel is invisible until it is joined.
  213.  
  214.     Topic Protection
  215.           If active, only Channel Operators may set or change the
  216.           topic of a channel.
  217.  
  218. Channel Operator (aka, Op)
  219.      A user who has control over a channel.  A user who creates a
  220.      channel is given Op status, and in turn can give it to anyone else
  221.      in the channel.
  222.  
  223. Command
  224.      A message to an IRC server or to a local or remote client.
  225.      Commands generally begin with a /.  See Commands.
  226.  
  227. CTCP
  228.      Client To Client Protocol, A standard for sending commands from
  229.      one client to another, usually for the purpose of getting
  230.      information from the remote client.  See CTCP.
  231.  
  232. DCC
  233.      Direct Client Connection - a standard for creating a direct link
  234.      between two clients, for the purpose of sending or receiving
  235.      files, or to carry a more secure conversation.  See DCC.
  236.  
  237. Efnet
  238.      (Eris Free), the largest and "main" IRC network, with an average
  239.      of about 5000 users on any given day.
  240.  
  241. Identd
  242.      Identd Is software that can be run on the client, allowing an IRC
  243.      server to corroberate the identity of a client.  AmIRC has an
  244.      Identd built in, and will automatically disable it if an external
  245.      Identd is running.
  246.  
  247. IRC
  248.      Internet Relay Chat - Any Network of Computers that run IRC
  249.      servers for the purpose of allowing users to connect to it
  250.      using client software made for IRC.
  251.  
  252. Kick
  253.      The occurance of a user being removed from a joined channel by
  254.      a channel operator.
  255.  
  256. MOTD
  257.      Message Of The Day, A message that may or may not be updated
  258.      daily, that is meant to be read when connecting to an IRC
  259.      server.
  260.  
  261. Netsplit
  262.      An event that occurs when a server goes down that other servers
  263.      depend on for network packets. Any servers that are dependant on
  264.      the crashed server will split from the net, that is, they will
  265.      still be up and running, with active clients, but any clients on
  266.      the other side of the crashed unit will appear to have all logged
  267.      off at once.
  268.  
  269. Nick
  270.      Short for Nickname, this is an alias that you may pick for
  271.      yourself.
  272.  
  273. Op
  274.      See Channel Operator.
  275.  
  276. Server
  277.      A computer that is Running IRC server software, allowing it to be
  278.      connected to by IRC clients or other servers.
  279.  
  280. Server Operator
  281.      A person in control of an IRC server.
  282.  
  283. TLA (Three Letter abreiviations)
  284.      commonly used acronyms, not entirely restricted to 3 letters.
  285.  
  286.     AFAIK
  287.           As Far As I Know
  288.  
  289.     AFK
  290.           Away From Keyboard
  291.  
  292.     BRB
  293.           (I'll) Be Right Back
  294.  
  295.     BBL
  296.           (I'll) Be Back Later
  297.  
  298.     IMHO
  299.           In My Humble|Honest Opinion
  300.  
  301.     LOL
  302.           Laughs Out Loud
  303.  
  304.     MOTD
  305.           Message Of The Day
  306.  
  307.     ROTFL
  308.           Rolls On The Floor Laughing
  309.  
  310.     RTFM
  311.           Read The F***ing Manual
  312.  
  313. Topic
  314.      A heading for a channel that may or may not have anything to do
  315.      with the conversation at hand.
  316.  
  317. Undernet
  318.      The second largest IRC network, considered an 'Alternative' to
  319.      EFnet.
  320.  
  321. User
  322.      a person using an IRC Client to connect to a server to chat.
  323.  
  324. User Mode
  325.      Settings that affect a users properties.
  326.  
  327.     Invisible
  328.           If this mode is set, a user will be invisible in the global
  329.           user list.  The user will still be visible in the user list
  330.           of any joined channel, however.
  331.  
  332.     Wallops
  333.           When set, this mode will allow receiving of messages from the
  334.           server operator to all operators.
  335.  
  336. Userhost
  337.      This is the string that defines a user.  It consists of the
  338.      user's chosen nick, login name and domain name.  For example:
  339.      Wupper!jwupper@monorail.wupper.de
  340.      |      |       |        |      |_ Domain
  341.      |      |       |        |________ Network
  342.      |      |       |_________________ Machine
  343.      |      |_________________________ Login
  344.      |________________________________ Nick
  345. Voice
  346.      Status a normal (not an operator) user must have to type into a
  347.      moderated channel.
  348.  
  349. Things that make AmIRC special!
  350. *******************************
  351.  
  352. Features
  353. ========
  354.  
  355.    * runs with both AmiTCP and AS225 without additional support
  356.      libraries.
  357.  
  358.    * built-in high speed DCC drivers for SEND and MOVE.  Highly
  359.      optimized with asynchronous file I/O and threaded network
  360.      handling. Supports Drag&Drop sending of files.
  361.  
  362.    * transparent implementation of DCC CHAT. All /MSGs are
  363.      automatically routed via DCC CHAT if applicable, to save runtime
  364.      and reduce IRC load. Option to automatically accept DCC CHAT
  365.      connections.
  366.  
  367.    * ultra fast text output and scrolling. Supports Cut&Paste for the
  368.      list text. Supports proportional fonts.
  369.  
  370.    * full support of the "Undernet" IRC extensions, both reply codes and
  371.      additional IRC commands.
  372.  
  373.    * intuitive channel display with userlist and channel mode overview.
  374.      Channel modes can easily be changed via gadgets. Configurable user
  375.      action list to perform whatever action you like on users in channel
  376.      by the press of a mousebutton.
  377.  
  378.    * supports QUERY windows for private chat.
  379.  
  380.    * supports "smart" banning
  381.  
  382.    * versatile AREXX port including server message parsing ("event
  383.      trapping") and commandline/script interaction.
  384.  
  385.    * easy command line aliasing.
  386.  
  387.    * builtin IdentD (automatically disabled if another IdentD is already
  388.      installed).
  389.  
  390.    * supports nick notification, highlighting, ignoring, and kickban.
  391.  
  392.    * versatile event handling allows you to bind sound effects,
  393.      auto-deiconify or rexx scripts to certain events.
  394.  
  395.    * server phonebook.
  396.  
  397.    * last nick history.  Stores the nicknames of the last nicks you've
  398.      send MSGs to, received MSGs from or addressed publically with
  399.      "nick:".  Reference can be used in all commands which require nick
  400.      names, e.g.  /MSG, /OP, /DEOP. Automatic nick expansion on public
  401.      messages with ":".
  402.  
  403.    * TAB messaging to automatically cycle the list of last used
  404.      nicknames with a /MSG prefix.
  405.  
  406.    * auto rejoin channel on KICK and auto reconnect server facility.
  407.  
  408.    * auto away after idle timeout. Auto unaway after sending public
  409.      and/or private msgs.
  410.  
  411.    * auto update download.  Check for and download new releases with a
  412.      simple click.
  413.  
  414.    * URL grabber for interfacing with a web browser..
  415.  
  416.    * Support for DALnet extensions.
  417.  
  418. What is needed to run AmIRC?
  419. ****************************
  420.  
  421. Hardware
  422. ========
  423.  
  424. AmIRC was written for the Amiga family of computers, and has been
  425. tested on 1200, 2000, 3000, & 4000 computers in various configurations.
  426.  
  427. Software
  428. ========
  429.  
  430. AmIRC requires About MUI v.3.1 or later in order to run.
  431.  
  432. AmIRC requires KickStart & WorkBench 2.x or later, with setpatch 40.16
  433. installed.
  434.  
  435. AmIRC020 requires a 68020 or higher CPU, OS3.0 or newer, and MUI 3.1 or
  436. newer.  If you do not have anyone of these, you must use the 68000
  437. version of AmIRC.
  438.  
  439. If you plan to run a TCP/IP stack and MUI and AmIRC, among other
  440. Internet applications, you should have at least 2 megabytes of RAM.
  441.  
  442. Finally, You need to have a tcp/ip protocol stack running, such as
  443. AmiTCP/IP or Amiga Technology's as225r2 tcp/ip protocol stack, With a
  444. slip, cslip, or ppp connection to the internet or an ethernet LAN.
  445.  
  446. Alternatively, AmIRC will work with Multilink and a shell internet
  447. account.  NOTE: As Mlink does not automatically set the HOSTNAME
  448. variable, this must be done when starting mlink. Env:hostname must
  449. contain the full domain name for your amiga, i/e
  450. 'calci.amiganet.pgh.net'.
  451.  
  452. You must have OS 3.x in order to use sounds in AmIRC.
  453.  
  454. Getting AmIRC to run
  455. ********************
  456.  
  457. Requirements
  458. ============
  459.  
  460. AmIRC has its own installer script and requires that you have the Amiga
  461. installer utility (version 1.24 or later) located in your sys:c
  462. directory.  To install, just click on the install icon, and answer the
  463. questions in the installer's requestors.
  464.  
  465. If you cannot or prefer not to use the installer utility, a manual
  466. install is very simple, just move the contents of the archive to a
  467. directory of your choice and it's ready to use.  If you have met the
  468. Requirements for the optimized version of AmIRC, delete the AmIRC file
  469. and rename "AmIRC020" as "AmIRC".
  470.  
  471. Connecting to a server
  472. **********************
  473.  
  474. Setup
  475. =====
  476.  
  477. Once you have Installation AmIRC, run the AmIRC program from WB by
  478. clicking on its icon. After a few moments you will see the server
  479. connect requester appear. First type in a nickname in the first text
  480. gadget at the top of the requester.  If you intend to use a nick that
  481. may be common, try typing in some variations in the next three boxes.
  482. this way, if your nick is in use by another person, the client will
  483. retry with the next nick.
  484.  
  485. Next, enter your real name and your email address or www home page URL
  486. in the next text gadget. It is probably a good idea to be truthful
  487. here. :)
  488.  
  489. Then, enter a username that will show as
  490. «username»@machine.network.org.  «username» should be the same as the
  491. login ID for your service provider.
  492.  
  493. Now you are ready to connect.  Just click on a server from the supplied
  494. list or click new server entry and type the address and port number of
  495. your favorite server and then click connect. Optionally, you can choose
  496. one or a few channels to autojoin, just separate them with a comma.  If
  497. you are already connected, and wish to connect to a second server,
  498. click connect thread to open a second instance of AmIRC. The Delete
  499. Server Entry gadget will remove a server entry that you no longer wish
  500. to use.
  501.  
  502. How Does AmIRC Work?
  503. ********************
  504.  
  505. Using the Interface
  506. ===================
  507.  
  508. The AmIRC user interface is laid out in a logical, intuitive manner,
  509. making it easy to use.
  510.  
  511. Text Listview
  512.      The main feature of the interface is the text listview, where
  513.      incoming text is displayed.
  514.  
  515. Text Input Gadget
  516.      Directly below this is the text input gadget, labeled with the
  517.      nickname that you have chosen. Any text entered here will be sent
  518.      out to the IRC server.
  519.  
  520. Listview Scroll Gadget
  521.      To the right of the listview is a scroll gadget, which enables you
  522.      to scroll backward through the text in the listview.
  523.  
  524. Channel Text String
  525.      At the top left of the listview is a text string that reflects the
  526.      channel that you have joined.
  527.  
  528. Topic Input/Display Gadget
  529.      To the right of the channel text string, is the Topic
  530.      Input/Display gadget, where the topic of a joined channel will be
  531.      displayed.  If you have Channel Operator (Ops) Status, you may
  532.      change the topic of the channel by entering the topic in this
  533.      gadget, and hitting the 'enter' key.
  534.  
  535. Operator Buttons
  536.      To the right of the topic input gadget are the channel mode
  537.      buttons, which display the current modes for the joined channel.
  538.      Users with Channel Operator (Ops) status may also use these
  539.      buttons to change the current channel modes.
  540.  
  541.     T - Topic Protection
  542.           Toggles Topic Protecton on/off.  If on, the topic can be
  543.           changed by Channel Operators (Ops) only.
  544.  
  545.     N - No Messaging
  546.           Toggles Messaging on/off.  If active, a user can only write
  547.           to the channel if they have joined it.
  548.  
  549.     S - Secret
  550.           Toggles Secret mode on/off.  If active, the channel is
  551.           invisible until it is joined.
  552.  
  553.     I - Invite Only
  554.           Toggles Invite Only mode on/off.  If active, users can only
  555.           join after they have been invited.
  556.  
  557.     P - Private
  558.           Toggles Private mode on/off.  If active, the channel will be
  559.           invisible in the global channel list.
  560.  
  561.     M - Moderated
  562.           Toggles Moderated mode on/off.  If active, only channel
  563.           operators (Ops) and users with 'voice' can type to the
  564.           channel.
  565.  
  566.     L - Limit
  567.           Sets a limited number of users allowed on the channel
  568.  
  569.     K - Keyword
  570.           Toggles Keyword mode on/off.  If active, Users can only join
  571.           the channel if they give the correct keyword.
  572.  
  573.     B - Ban
  574.           Sets/Displays the current Bans active on the channel
  575.  
  576. User Listview
  577.      Below the channel mode buttons is the User Listview, which shows a
  578.      current list of users on the joined channel.  Double clicking on a
  579.      users name will perform a /whois on that user.  Clicking once on a
  580.      users name will set that user as the default to perform other
  581.      operations on, such as an operation from the configurable user
  582.      buttons.
  583.  
  584. User Buttons
  585.      Directly below the User Listview are the user buttons.  These
  586.      buttons are configurable from the GUI window, accessable by
  587.      selecting 'setup...' from the AmIRC Settings menu.
  588.  
  589. Special Functions:
  590.      You can Drag-Hilight text in the listview in order to paste it
  591.      elsewhere.  you will need some type of snap utility such as
  592.      newedit or powersnap in order to past the text.  The text is
  593.      stored in the clipboard.
  594.  
  595.      The TAB key will cycle through the names of people that have
  596.      previously /msg'ed you, and insert it into the text input gadget.
  597.      Simply enter your message after the "/msg <user> " in order to
  598.      /msg them back.
  599.  
  600.      Entering ":" first in the text input gadget will automatically
  601.      publicly address the last person you typed to using the ":" after
  602.      their nick.
  603.  
  604. Pull-Down Menus
  605. ***************
  606.  
  607. Reference
  608. =========
  609.  
  610. AmIRC Menu
  611. ----------
  612.  
  613. Select Server...
  614.      Opens a window from which you can select various options for
  615.      connecting to an IRC server. See Connecting.
  616.  
  617. Logging Enabled?
  618.      Toggles logging on/off.
  619.  
  620. Iconify
  621.      Reduces the AmIRC window to an icon on the Workbench screen.
  622.  
  623. Help...
  624.      Opens Amirc.guide for reference while using AmIRC.
  625.  
  626. About...
  627.      Opens a window with information about AmIRC and its Developer.
  628.      Here you may connect to the AmIRC home page if amosaic is running
  629.      concurrently, and you may also download the latest version of
  630.      AmIRC without having to trouble with running a www or ftp client.
  631.  
  632. Quit
  633.      Will close the current instance of AmIRC, leaving other instances
  634.      open.
  635.  
  636. Windows Menu
  637. ------------
  638.  
  639. Channel Windows
  640.      If more than one AmIRC window is opened, You may select one here
  641.      to pop it to front.
  642.  
  643. Dialog Windows
  644.      If any dialog windows are open, you may select one her and bring
  645.      it to front.
  646.  
  647. Channel List Window...
  648.      This item will produce a requester where you may list channels by
  649.      min users or pattern matching, or both. Once listed, you may list
  650.      users on a channel or join it by double-clicking the channel name
  651.      or selecting 'join channel' gadget.  Please note that this
  652.      function can cause a high load of traffic and may take awhile on
  653.      slow (14.4 or less) connections.
  654.  
  655. Notify Window...
  656.      Selecting this item will produce a requester where you may enter
  657.      nicks of users that you wish to be notified of their
  658.      entering/leaving IRC.  The 'check period' is how often AmIRC will
  659.      check for the specified users.  Add a nick to the list by clicking
  660.      in the input text gadget, and typing in the nick.  delete a nick
  661.      by clicking on it's entry and then click on 'delete nick' gadget.
  662.  
  663. DCC-Send Window...
  664.      Brings up a requestor in which you can specify a user and a file
  665.      to send to them.  This requester will also be produced
  666.      automatically upon hitting the 'DCC send' userbutton on the
  667.      interface.  'Send Path' is the path and filespec that will be sent
  668.      to the user.  Enter the name of the user in the text input gadget
  669.      at the bottom of the requestor.  The cycle gadget nest to the nick
  670.      text gadget selects either 'DCC Send' or 'DCC Move' protocols.
  671.      See DCC for details about these protocols.  Remove Job gadget
  672.      will remove a complete send entry or if not complete, one click
  673.      will abort the send and the second click will remove the entry.
  674.  
  675. DCC-Receive Window...
  676.      Selecting this item will produce the 'Receive DCC List' requester.
  677.      This is very similar to the DCC Send Requester.  Note that this
  678.      requester will appear automatically on receiving a DCC request.
  679.      Enter a path for incoming files to be put in the 'Receive Path'
  680.      text gadget.  After a valid path is entered, click on an entry to
  681.      receive, then click the 'Get' gadget at the bottom.  If you are
  682.      trying to receive after a failed send, you may use the 'Resume'
  683.      gadget instead of get.  this will attempt to pick up the transfer
  684.      where it left off.  I you wish to rename the incoming file for
  685.      whatever reason, you may use the 'Rename' gadget to give the file
  686.      a new name.  'Remove Job' gadget will abort an incoming file and
  687.      remove a completed or aborted file. See DCC.
  688.  
  689. DCC-Chat Window...
  690.      Selecting this item will open the 'DCC Chat List' requestor.  Do
  691.      this if you receive a DCC chat request from another user..  Here
  692.      you may click on the client sending the chat request and click the
  693.      'Open' gadget to engage a DCC chat.  When finished, you can click
  694.      "Close' to close the connection.  See DCC.
  695.  
  696. Raw Log Window...
  697.      This will open the Raw Log Window, in which you can view the raw
  698.      IRC messages as they appear before AmIRC formats them for Easy
  699.      reading in the AmIRC listview.  Here you may also clear the log,
  700.      and select when the log is active: 'Never', 'Only when raw window
  701.      open', and 'Always' The log Listview shows the USERHOST, Type of
  702.      message, Channel Name, and message, in that order.
  703.  
  704. URL Grabber Window...
  705.      A New feature of AmIRC allows it to recognise WWW URLs and snap
  706.      them to a window for use with Amosaic Web Browser.  Double
  707.      clicking an entry in the URL grabber Window will automatically
  708.      send the URL to the Clipboard..
  709.  
  710. Private Messages Window...
  711.      This item will open the Private Messages Window.  This window
  712.      holds a history of private messages sent to you, where you can
  713.      later reference or review them.
  714.  
  715. Flush Buffer
  716.      This item will clear the history of the main AmIRC listview.
  717.  
  718. Save Buffer...
  719.      This item allows you to select a filename to save the history
  720.      buffer to disk.
  721.  
  722. User Modes Menu
  723. ---------------
  724.  
  725. Invisible?
  726.      Toggles your client between invisible or not invisible. See IRC
  727.      Terms.
  728.  
  729. Receive Wallops?
  730.      Toggles this mode on/off.  See IRC Terms.
  731.  
  732. Receive Server Notices?
  733.      Toggles this mode on/off.
  734.  
  735. Marked AWAY?
  736.      Toggles AWAY on/off.
  737.  
  738. Auto rejoin on KICK?
  739.      If set, will automatically attempt to reconnect you to a channel
  740.      you have been kicked from. Note that if a ban was set with the
  741.      kick, you will not be able to rejoin.
  742.  
  743. Auto reconnect to server?
  744.      If set, this will automatically attempt to reconnect you to the
  745.      server if you are disconnected for any reason.
  746.  
  747. Auto open Dialog Windows?
  748.      If set, will automatically open chat window upon receipt of a /msg
  749.      or dcc chat message.
  750.  
  751. Auto accept dcc chat requests?
  752.      If set, this will automatically accept a dcc chat request.  It
  753.      will not open a chat window for you, however. Do this by opening
  754.      the DCC chat window in the Windows menu.
  755.  
  756. Do BEEPS?
  757.      If set, AmIRC will send audio beeps (or samples, if configured in
  758.      the Events page of the settings requester) for certain events.
  759.  
  760. Settings Menu
  761. -------------
  762.  
  763. Setup...
  764.      Calls the AmIRC Setup, allowing you to change the many settings of
  765.      AmIRC to suit your needs.
  766.  
  767. Lists...
  768.      Calls up the Lists, allowing you to configure AmIRC's Alias,
  769.      Ignore, and Hilite lists.
  770.  
  771. Function Keys...
  772.      Calls the Function Keys, allowing you to configure the function
  773.      key macros.
  774.  
  775. Dialog Window Buttons?
  776.      If set, the AmIRC dialog window will contain 4 gadgets in the
  777.      upper right corner.  These are labeled: 'Whois', 'Ping', 'DCC
  778.      Chat', & 'DCC Send'.  These gadgets will perform their respective
  779.      functions on the user that the dialog window is opened to.
  780.  
  781. Load Settings...
  782.      Opens a requestor allowing you to recall previously saved
  783.      non-default AmIRC Configurations.
  784.  
  785. Load settings from default
  786.      Reloads the last saved default configuration
  787.  
  788. Save Settings Saves the current configuration under the last name set
  789.      in the 'Save settings as...' menu item.  If the settings have not
  790.      previously been named, they are saved as default.
  791.  
  792. Save settings as...
  793.      Opens a requester allowing you to choose a filename to save the
  794.      current AmIRC configuration as other than default.
  795.  
  796. Save as default
  797.      Saves the current AmIRC configuration as the default startup
  798.      configuration.
  799.  
  800. Create icons?
  801.      If Checked, will create icons for saved configuration files,
  802.      allowing them to be seen on the Workbench.
  803.  
  804. MUI Settings...
  805.      Opens the MUI Prefs program for altering the MUI Configurable AmIRC
  806.      configuration.
  807.  
  808. Rexx Menu
  809. ---------
  810.  
  811. This menu will Display any ARexx scripts that reside in AmIRC/Rexx/
  812. directory. AmIRC ARexx scripts should be named with the .amirx
  813. extension.  From this menu you may execute any existing AmIRC ARexx
  814. script.
  815.  
  816. Sending commands to other people
  817. ********************************
  818.  
  819. Introduction
  820. ============
  821.  
  822. CTCP or Client To Client Protocol
  823. ---------------------------------
  824.  
  825. CTCP is a standard for sending commands to other clients on IRC.
  826. Basically, CTCP messages are simply private messages that include a
  827. code to alert the receiving client (not user) to respond to the command.
  828.  
  829. CTCP commands are typicaly used to get informaton from the receiving
  830. client, such as /CTCP time, or /CTCP version. Even DCC sends a request
  831. via CTCP to the receiving client, asking to initiate a direct
  832. connection.
  833.  
  834. CTCP Commands
  835. -------------
  836.  
  837.          
  838.  
  839.    * ME (CTCP Action)
  840.               Template: /ME <action>
  841.      This will mark the message as an action and replace the /ME with
  842.      your nick, for example, '/me hates ice cream' would appear as:
  843.          [Action]  |Fred hates ice cream
  844.  
  845.          
  846.  
  847.    * Version
  848.               Template: /CTCP <user> Version
  849.      Version will ask the client to return information about itsself,
  850.      which will be in the form of a private message.
  851.  
  852.          
  853.  
  854.    * Time
  855.               Template: /CTCP <user> Time
  856.      Time will return the time of day as it is set on the user's
  857.      machine.
  858.  
  859.          
  860.  
  861.    * Ping
  862.               Template: /ping <user>
  863.      Ping will send a packet request to the receiving client, which
  864.      will in turn send back the packet with a timestamp, where the
  865.      inititating client will compare the time difference and show the
  866.      result in the listview.
  867.  
  868. Direct client connections
  869. *************************
  870.  
  871. What is DCC?
  872. ============
  873.  
  874. DCC or Direct Client Connection is a protocol that IRC clients can use
  875. to communicate directly with each other, bypassing the IRC server.  The
  876. reason for this is to form a faster, more stable and direct connection
  877. thru which users can transfer files, or send private messages.
  878. Note that AmIRC has its own set of Highly Optimized DCC protocols
  879. built-in, and does not require external DCC utilities.
  880.  
  881. DCC File Transfers
  882. ==================
  883.  
  884. The most common use of DCC is for transferring files between two
  885. clients.  The initiating client will send a message through the IRC
  886. server, telling the receiver that a connecton is requested.  At this
  887. time, the receiver will either accept or reject the offer for the
  888. connection.  If the receiver accepts the connection, the initiating
  889. client will proceed to send the information directly to the receiver.
  890. If the connecton is refused, the initiating client will simply timeout
  891. the attempt to connect.
  892.  
  893. DCC Send
  894. --------
  895.  
  896.     Template: /DCC send <user> <filespec>
  897.      DCC send will attempt to open a connecton with the specified user's
  898.      client, and if successful, will proceed to send the specified file.
  899.  
  900. DCC Move
  901. --------
  902.  
  903.     Template: /DCC move <user> <filespec>
  904.      DCC Move is identical to DCC Send, with the exception that DCC move
  905.      is capable of resuming an interrupted or failed transfer.  DCC Move
  906.      will look into the receiving directory for existing files, and upon
  907.      finding a partial file which is the same as the file to be transferred,
  908.      will initiate a /DCC Resume transfer.  With AmIRC, This process
  909.      is completely transparent.  If no partial or whole file exists, then
  910.      the file will be completely transferred.
  911.  
  912. DCC Get
  913. -------
  914.  
  915.     Template: /DCC get <user sending file>
  916.      DCC get is a transparent operation with AmIRC, and is only mentioned
  917.      in this document for the sake of being thorough.  AmIRC will notify
  918.      you of an incoming DCC request, and allow you the option to accept
  919.      or reject the connecton with a simple click.
  920.  
  921. DCC Chat
  922. ========
  923.  
  924. Another use of the DCC standard is DCC chat, which, like DCC Send, will
  925. send a CTCP request to the receiving client to set up a direct link.  In
  926. this case, however, the purpose of the link is for users to send
  927. messages to each other.  Because the mesages are sent through the
  928. direct link, and do not pass through the IRC server, this method of
  929. sending messages is much more private than using the IRC's privmsg
  930. (/msg).
  931. With AmiRC, it must be noted that a DCC Chat request will not open a
  932. dialog window for you, instead, when DCC chat is initiated and accepted,
  933. all privmsg's (/msg) to the receiving user will be sent through the DCC
  934. link.  If you wish to have a dialog box for chatting, the best way to go
  935. about this is to highlight the users's name in the listview by clicking
  936. on it.  then click on the 'Query' gadget below the listview.  this will
  937. open a window that has several options within it. From here, you can
  938. 'ping' or 'whois' the other user, or you may inititate a 'DCC Send' or
  939. 'DCC chat'.  Starting a 'DCC Chat' from this window will allow you to
  940. carry on a dialog with the remote user through the window.
  941.  
  942. Commands
  943. ********
  944.  
  945. Overview
  946. ========
  947.  
  948. AmIRC has several builtin commands. Some of these commands are
  949. processed locally, whereas others are sent to the IRC server.
  950.  
  951. Commands generally start with a / to differentiate them from normal
  952. text. If you want to use the / character at the start of normal text,
  953. use // instead.
  954.  
  955. Many commands require a channel name as a parameter. AmIRC will
  956. automatically fill in the channel name of the current window if you
  957. don't specify a channel name on your own.
  958.  
  959. For commands which require a nick name (e.g. /MSG or /OP, there
  960. are three special shortcut arguments:
  961.  
  962. .
  963.      The period is replaced with the nickname of the last person you
  964.      have send a private message to.
  965.  
  966. ,
  967.      The comma is replaced with the nickname of the last person who
  968.      send a message to you. Be careful with this, since you might
  969.      easily address the wrong person if someone sends you a message
  970.      while you are still typing this command!
  971.  
  972. :
  973.      The colon is replaced with the nickname of the last person which
  974.      you haved a addressed with a nick: prefix inside a channel.
  975.  
  976. You may easily carry a dialog with a particular user by first clicking
  977. on their username in the user list, then anytime you hit the tab key,
  978. the input string will be set up with '/msg <user> ', after which you
  979. may type in the message and hit return.  This will work after
  980. initiating a DCC Chat request as well.  Please note that if you have
  981. configured the user list as a separate window, you must reactivate the
  982. message window after clicking on a username.
  983.  
  984. Reference
  985. =========
  986.  
  987. AWAY
  988. ----
  989.  
  990. Usage: /AWAY [message]
  991.  
  992. When used with the optional <message> argument, /AWAY will mark you as
  993. being away and send the message to any client sending a MSG to you.
  994. otherwise, it will remove a previously set away message.
  995.  
  996. EXAMPLES:
  997.  
  998. /AWAY eating dinner
  999.      will send the message '<nick> is away: eating dinner', where nick
  1000.      is the nickname of the user that is away.
  1001.  
  1002. /AWAY
  1003.      will remove a previously set Away Message.
  1004.  
  1005. INVITE
  1006. ------
  1007.  
  1008. Usage: /INVITE <nickname> <channel>
  1009.  
  1010. Invites a user to the channel given in the argument, regardless of
  1011. weather the channel exists.  If the named channel is MODE, the user
  1012. performing the command must be a channel operator for that channel.
  1013.  
  1014. EXAMPLES:
  1015.  
  1016. /INVITE freddie #amiga
  1017.      Sends a message to 'freddie', inviting him to join #amiga.
  1018.  
  1019. ISON
  1020. ----
  1021.  
  1022. Usage: /ISON <nickname>{<space><nickname>}
  1023.  
  1024. Quickly returns the users nick if it is found, does nothing if it is
  1025. not.
  1026.  
  1027. EXAMPLES:
  1028.  
  1029. /ISON Kenneth
  1030.      Returns: '<ISON>Kenneth', if nick 'Kenneth' is found on the
  1031.      server.
  1032.  
  1033. JOIN
  1034. ----
  1035.  
  1036. Usage: /JOIN channel[,channel[,...]] [key[,key[,...]]]
  1037. Usage: /CHANNEL channel[,channel[,...]] [key[,key[,...]]]
  1038.  
  1039. Join a channel on the IRC.  If the channel doesn't exists, it is
  1040. automatically created.
  1041.  
  1042. There are two kinds of channels:  Channel names starting with an
  1043. # are global channels and available on all IRC servers which
  1044. are connected to the net you are currently on.  Channels which begin
  1045. with & are local to the chat server you are connected to.
  1046.  
  1047. If a channel requires a special keyword to join, you must submit this
  1048. after the channel name.
  1049.  
  1050. AmIRC will look for a channel window which isn't currently bound to a
  1051. channel. If it doesn't find one, a new window will be created and bound
  1052. to this channel.
  1053.  
  1054. EXAMPLES:
  1055.  
  1056. /JOIN #Amigager
  1057.      Join channel #AmigaGER
  1058.  
  1059. /JOIN #Amigager,#Amiga
  1060.      Join channels #AmigaGER and #Amiga
  1061.  
  1062. /JOIN #AmigaGER deutsch
  1063.      Join channel #AmigaGER with keyword deutsch.
  1064.  
  1065. RELATED TOPICS:
  1066.  
  1067. See LEAVE.
  1068.  
  1069. KICK
  1070. ----
  1071.  
  1072. Usage: /KICK <channel> <user> [<comment>]
  1073.  
  1074. Forcibly removes a user from the named channel.  the user sending the
  1075. /KICK command must be a channel operator of the named channel.  If the
  1076. optional <comment> is given, it will be shown as the reason for the
  1077. kick.
  1078.  
  1079. EXAMPLES:
  1080.  
  1081. /KICK #amiga Freddie Take it outside!
  1082.      forces 'Freddie' from channel #amiga with the reason 'take it
  1083.      outside'.
  1084.  
  1085. LEAVE
  1086. -----
  1087.  
  1088. Usage: /LEAVE [channel[,channel[,...]]
  1089.  
  1090. Leaves a channel. If you don't give a channel name as a parameter, the
  1091. channel currently bound to the window in which in the command is
  1092. entered will be left.
  1093.  
  1094. EXAMPLES:
  1095.  
  1096. /LEAVE
  1097.      Leave the channel currently bound to this window.
  1098.  
  1099. /LEAVE #AmigaGER
  1100.      Leave channel #AmigaGER.
  1101.  
  1102. RELATED TOPICS:
  1103.  
  1104. See JOIN.
  1105.  
  1106. LIST
  1107. ----
  1108.  
  1109. Usage: /LIST [<channel>{,<channel>} [<server>]]
  1110.  
  1111. Generates a list of current channels and topics.  If the <channel>
  1112. argument is given, LIST displays that channel's status and topic.
  1113. Private channels show as 'Private' and secret channels are not listed,
  1114. unless the client generating the list is a member of those channels.
  1115.  
  1116. EXAMPLES:
  1117.  
  1118. /LIST
  1119.      Shows a list of all current, non-secret channels.
  1120.  
  1121. /LIST #amiga,#amigaGER
  1122.      List channels #amiga and #amigaGER
  1123.  
  1124. Logging Options
  1125. ---------------
  1126.  
  1127. Usage: /LOG {[on|off|<Filespec>]}
  1128.  
  1129. /LOG allows you to start/stop logging, as well as setting the log
  1130. filename and displaying status of logging.
  1131.  
  1132. EXAMPLES:
  1133.  
  1134. /LOG
  1135.      Displays current status of logging
  1136.  
  1137. /LOG on
  1138.      Begins logging to the logfile
  1139.  
  1140. /LOG <filespec>
  1141.      Sets the path and name of the logfile.
  1142.  
  1143. Channel MODE
  1144. ------------
  1145.  
  1146. /MODE allows both users and channels to have their modes changed.
  1147.  
  1148. Usage: /MODE <channel> {[+|-]|o|p|s|i|t|n|b|v} [<limit>] [<user>] [<ban
  1149. mask>]
  1150.  
  1151. Used by Channel Operators to change the modes of 'their' channel.  the
  1152. modes available are:
  1153.  
  1154.      o - give/take channel operator privileges;
  1155.      p - private channel flag;
  1156.      s - secret channel flag;
  1157.      i - invite-only channel flag;
  1158.      t - topic settable by channel operator only flag;
  1159.      n - no messages to channel from clients on the outside;
  1160.      m - moderated channel;
  1161.      l - set the user limit to channel;
  1162.      b - set a ban mask to keep users out;
  1163.      v - give/take the ability to speak on a moderated channel;
  1164.      k - set a channel key (password).
  1165.  
  1166. EXAMPLES:
  1167.  
  1168. /MODE #amiga +tm
  1169.      Sets topic protection and makes channel moderated for #amiga.
  1170.  
  1171. /MODE #amiga -o Sarek
  1172.      Removes channel operator status from user 'Sarek' on channel
  1173.      #amiga.
  1174.  
  1175. /MODE #amiga +l 50
  1176.      Sets limit of 50 users on #amiga.
  1177.  
  1178. /MODE #amiga -l
  1179.      Removes the limit form #amiga
  1180.  
  1181. User MODE
  1182. ---------
  1183.  
  1184. Usage: <nickname> {[+|-]|i|w|s|o}
  1185.  
  1186. These affect how a client is seen by others or what extra messages a
  1187. client will receive. User Modes will only take effect if the Nick of
  1188. the client sending the command, and the nick of the <nickname> argument
  1189. are the same.
  1190.  
  1191. Available User Modes:
  1192.      i - marks a users as invisible;
  1193.      s - marks a user for receipt of server notices;
  1194.      w - user receives wallops;
  1195.      o - operator flag.
  1196.  
  1197. Note that the +o user mode will not work, however, -o will.
  1198.  
  1199. EXAMPLES:
  1200.  
  1201. /MODE freddie +i
  1202.      makes user 'freddie' invisible in the global user list.
  1203.  
  1204. /MODE freddie -o
  1205.      User 'freddie' removes channel operator status from himself.
  1206.  
  1207. MSG (PRIVMSG)
  1208. -------------
  1209.  
  1210. Usage: /MSG <receiver>{,<receiver>} <text to be sent>
  1211.  
  1212. Sends a Private Message to one or more users. Note that this is
  1213. different from a DCC, in that a /MSG (PRIVMSG) is sent thru the IRC
  1214. server to the recipient.  Note that the TAB key will cycle back and
  1215. forth through the users who have /msg'ed you.  This will appear in the
  1216. input string gadget, and you may simply add your message after it.
  1217.  
  1218. EXAMPLES:
  1219.  
  1220. /MSG Kenneth Heya Dude! How's Florida?
  1221.      Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'.
  1222.  
  1223. /MSG Kenneth,Aerosoul I am in Pittsburgh
  1224.      Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul.
  1225.  
  1226. Names
  1227. -----
  1228.  
  1229. Usage /NAMES [<channel>{,<channel>}]
  1230.  
  1231. Gives a list of nicknames on any channel visible to the user(not secret
  1232. or private, or one actually joined by the user performing the command).
  1233.  
  1234. EXAMPLES:
  1235.  
  1236. /NAMES #amiga,#amigaGER
  1237.      Will list all users on channels #amiga and #amigaGER, provided the
  1238.      channels are visible to the user.
  1239.  
  1240. /NAMES
  1241.      Will return a list of all visible channels and users (Strongly
  1242.      Discouraged!)
  1243.  
  1244. NICK
  1245. ----
  1246.  
  1247. Usage: /NICK <nickname>
  1248.  
  1249. NICK is used to to give yourself or change your current nickname.  If
  1250. the chosen nick is already in use, you wil be notified of this and
  1251. prompted for a new nick.
  1252.  
  1253. EXAMPLES:
  1254.  
  1255. /NICK Phalanx
  1256.      Makes/changes your nickname to 'Phalanx'
  1257.  
  1258. NOTICE
  1259. ------
  1260.  
  1261. Usage: /NOTICE <nickname> <text>
  1262.  
  1263. Smiilar to /MSG, /NOTICE is usually used by Bots or clients being
  1264. controlled by scripts.  /NOTICE messages must never be responded to by
  1265. an automatic reply.  See MSG for syntax examples.
  1266.  
  1267. QUIT
  1268. ----
  1269.  
  1270. Usage: [<Quit message>]
  1271.  
  1272. Used to End an IRC session.  The optional <quit message> is the text
  1273. that will be displayed upon quitting.
  1274.  
  1275. EXAMPLES:
  1276.  
  1277. /QUIT :Gone to have lunch
  1278. RAW
  1279. ---
  1280.  
  1281. Usage: /RAW text
  1282.  
  1283. Sends text directly to the IRC server without any further processing.
  1284. Warning: Don't even think about using this command without interior
  1285. knowledge of the IRC protocol, or you might run into severe trouble.
  1286. See `RFC 1459' for a description of the IRC protocol.
  1287.  
  1288. EXAMPLES:
  1289.  
  1290. /RAW JOIN #IRC-Heros
  1291.      Send the string JOIN #IRC-Heros directly to the IRC server.
  1292.  
  1293. RELATED TOPICS:
  1294.  
  1295. `RFC 1459'.
  1296.  
  1297. TIME
  1298. ----
  1299.  
  1300. Usage: /TIME [<server>]
  1301.  
  1302. Returns the time of day from the server.  If the optional <server>
  1303. argument is given, then that servers local time will be returned.
  1304.  
  1305. EXAMPLES:
  1306.  
  1307. /TIME irc.pitt.edu
  1308.      Returns the local time from server 'irc.pitt.edu'
  1309.  
  1310. TOPIC
  1311. -----
  1312.  
  1313. Usage: /TOPIC <channel> [<topic>]
  1314.  
  1315. The topic command alone will display the channels topic. if the optional
  1316. <topic> argument is given, the topic will be changed to the argument
  1317. given, provided that the topic is not protected, or the user issuing
  1318. the command is an operator on the channel. See MODE.
  1319.  
  1320. EXAMPLES:
  1321.  
  1322. /TOPIC #amiga
  1323.      Will display the current topic on #amiga.
  1324.  
  1325. /TOPIC #amiga Amigas Rule!
  1326.      Will replace the current topic of #amiga with the topic 'Amigas
  1327.      Rule'
  1328.  
  1329. USERS
  1330. -----
  1331.  
  1332. Usage: /USERS [<server>]
  1333.  
  1334. Returns a list of users on the server, or, optionally, on the specified
  1335. server.  /USERS may be disabled on most servers for security reasons.
  1336.  
  1337. EXAMPLES:
  1338.  
  1339. /USERS
  1340.      Returns a list of users on the current server
  1341.  
  1342. /USERS irc.colorado.edu
  1343.      Returns a list of users on server 'irc.colorado.edu'.
  1344.  
  1345. USERHOST
  1346. --------
  1347.  
  1348. Usage: /USERHOST <nickname>{<space><nickname>}
  1349.  
  1350. Returns the login@domain for the specified nickname.  Up to five
  1351. nicknames may be specified, each separated by a <space>.
  1352.  
  1353. EXAMPLES:
  1354.  
  1355. /USERHOST DuRaN
  1356.      returns: 'DuRaN is DuRaN@calci.amiganet.pgh.net
  1357.  
  1358. VERSION
  1359. -------
  1360.  
  1361. Usage /VERSION [<server>]
  1362.  
  1363. Returns the version of the server's software.  If the optional <server>
  1364. arguement is given, returns the version of the specified server's
  1365. software.
  1366.  
  1367. EXAMPLES:
  1368.  
  1369. /VERSION *.edu
  1370.      Returns server version information for all servers matching
  1371.      '*.edu'.
  1372.  
  1373. WHO
  1374. ---
  1375.  
  1376. Usage: /WHO [<name> [<o>]]
  1377.  
  1378. Returns a generated list of all users matching the criteria passed to
  1379. the command, i/e. everyone at a particular site, or on a particular
  1380. server.  If the optional <o> argument is specified, /WHO will only
  1381. return information on users that are channel operators.
  1382.  
  1383. EXAMPLES:
  1384.  
  1385. /WHO *.cmu.edu
  1386.      Will list all users at the cmu.edu domain.
  1387.  
  1388. /WHO irc.pitt.edu o
  1389.      will list all operators on irc.pitt.edu server
  1390.  
  1391. WHOIS
  1392. -----
  1393.  
  1394. Usage: /WHOIS [<server>] <nickmask>[,<nickmask>[,...]]
  1395.  
  1396. Returns information about the specified user or users, that you are
  1397. allowed to see.  If the optional <server> argument is specified, then
  1398. information aobut the user in relation to that specified server will be
  1399. given, i/e idle time.
  1400.  
  1401. EXAMPLES:
  1402.  
  1403. /WHOIS Phalanx
  1404.      Returns available information about user 'Phalanx'.
  1405.  
  1406. /WHOIS irc.bu.edu Phalanx
  1407.      Asks server 'irc.bu.edu' for information on user 'Phalanx
  1408.  
  1409. WHOWAS
  1410. ------
  1411.  
  1412. Usage /WHOWAS <nickname> [<count> [<server>]]
  1413.  
  1414. returns information on a nick that no longer exists, due to the user
  1415. leaving the server or changing their nick. The optional <count> argument
  1416. specifies how many previous instances of the nick should be returned.
  1417. The optional <server> argument specifies a particular server to be
  1418. searched.
  1419.  
  1420. EXAMPLES:
  1421.  
  1422. /WHOWAS Aerosoul 5
  1423.      Checks for and returns available information on the last 5
  1424.      instances of the nick 'Aerosoul'.
  1425.  
  1426. Customizing your environment
  1427. ****************************
  1428.  
  1429. Overview
  1430. ========
  1431.  
  1432. Now that you have AmIRC running, you may want to get it to operate the
  1433. way you want it to, and to look pleasing as well.  This is achieved
  1434. thru both MUI preferences and AmIRC's Menu options.
  1435.  
  1436. Changing MUI Settings
  1437. *********************
  1438.  
  1439. MUI Preferences
  1440. ===============
  1441.  
  1442. Most of the configuration dealing with how AmIRC's GUI appears can be
  1443. customized with About MUI.  Check the 'MUI Settings...' entry under the
  1444. 'Settings' menu.  This will pop up MUI's interface, allowing you to
  1445. setup AmIRC's MUI Prefs, without disturbing any of your other MUI
  1446. configurations. Read the documentation for MUI to Learn more about the
  1447. operation of MUI Preferences.
  1448.  
  1449. Changing AmIRC Options
  1450. **********************
  1451.  
  1452. AmIRC Setup
  1453. ===========
  1454.  
  1455. Most of the setup functions appear in the 'Setup' entry under the
  1456. 'Settings' & 'Lists' menus. Here you will get a multi-requestor that
  1457. will allow you to access several pages that deal with configuring AmIRC.
  1458.  
  1459. Messages Page
  1460. *************
  1461.  
  1462. Misc Messages
  1463. =============
  1464.  
  1465. CTCP Userinfo
  1466.      The text in this string is what will be returned to a user who
  1467.      sends '/CTCP userinfo' to your client.
  1468.  
  1469. KICK Reason
  1470.      If you are a channel operator and /kick another user from the
  1471.      Channel, this test will appear as the reason for the /KICK.
  1472.  
  1473. Quit Messages
  1474. =============
  1475.  
  1476. Exit
  1477.      This will appear to users in the channel when you exit AmIRC.
  1478.  
  1479. New Server
  1480.      This text will appear to users in the channel when you select
  1481.      'Select Server' in the 'AmIRC' menu, and pick a new server to
  1482.      connect to.
  1483.  
  1484. System Reset
  1485.      This is the text to appear if you reboot your amiga (Crtl-
  1486.      amiga-amiga) while connected to a server.
  1487.  
  1488. AWAY Messages
  1489. =============
  1490.  
  1491. Default
  1492.      This is the text that will appear when you are set 'away' by
  1493.      selecting the 'Marked Away?' item in the 'User Modes' menu.
  1494.  
  1495. AutoAWAY
  1496.      text that appears when you are automatically set away due to
  1497.      inactivity.
  1498.  
  1499. Timeout
  1500.      This sets how much time will pass before AmIRC assumes you are
  1501.      away from the computer and marks you as 'AWAY'.
  1502.  
  1503. UnAWAY
  1504.      This cycle gadget allows you to choose the conditions of which
  1505.      AmIRC will automatically set you to 'Not AWAY'.
  1506.  
  1507. Actions Page
  1508. ************
  1509.  
  1510. Actions
  1511. =======
  1512.  
  1513. The 12 text gadgets in the 'Label:' column here correspond to the 12
  1514. gadgets under the user list on AmIRC's main window.  You may set these
  1515. gadgets to be anything, sort of like macros.  AmIRC, however, does
  1516. include configurable function keys to act as macros, so these gadgets
  1517. are preset for /ctcp, /dcc, and /mode operations.
  1518.  
  1519. Below the text gadgets is a quick reference of the placeholders that
  1520. can be used in the desired operation.
  1521.  
  1522. Events Page
  1523. ***********
  1524.  
  1525. Events
  1526. ======
  1527.  
  1528. Here you may define certain actions to take place upon incoming events.
  1529. These actions can be as simple as a warning beep from your amiga, or a
  1530. complex and powerful rexx command.  The following text first explains
  1531. the functions of the columns of this page, and then goes on to explain
  1532. what each event is.
  1533.  
  1534. Columns
  1535. -------
  1536.  
  1537. Event
  1538.      The particular event for the action to take place on.
  1539.  
  1540. Deiconify
  1541.      If AmIRC is iconified, this will uniconify and bring to front the
  1542.      AmIRC window on the occurence of the event.
  1543.  
  1544. Beep
  1545.      This will perform a system beep on the occurence of the event
  1546.  
  1547. Sound
  1548.      if a sound sample is preferred for the event, you may use the
  1549.      requestor gadget to pick a sound to play instead of the system
  1550.      beep.  Please Note, AmIRC uses the DataTypes of OS 3.x for sounds,
  1551.      and you will not be able to use this feature under OS 2.x.
  1552.  
  1553. Vol
  1554.      This sets the volume for the sound sample.  The valid range for
  1555.      the volume is 0 - 64.  This is a slider gadget.
  1556.  
  1557. Rexx Command
  1558.      Here you may configure a rexx script to be run on the occurence of
  1559.      the event.
  1560.  
  1561. Events
  1562. ------
  1563.  
  1564. Any Message
  1565.      This Event occurs on any incoming public message.
  1566.  
  1567. Private Msg
  1568.      This event occurs when you receive an incoming private /msg or /dcc
  1569.      chat message
  1570.  
  1571. Notice
  1572.      This event occurs when an operator sends out a /notice
  1573.  
  1574. CTCP request
  1575.      This event occures when your client receives any /ctcp request (for
  1576.      example /ctcp time, or /ctcp version
  1577.  
  1578. DCC request
  1579.      This event occurs on receiving a /dcc file transfer request or chat
  1580.      request.
  1581.  
  1582. Join
  1583.      This event occurs when anyone /joins the channel you are currently
  1584.      on.
  1585.  
  1586. Kick
  1587.      This event occurs when anyone is /Kicked from the channel you are
  1588.      currently on.
  1589.  
  1590. Mode change
  1591.      This event occurs when the channel mode is changed for the channel
  1592.      you are currently on, i/e. if someone is /OPed or /DeOPed, or if
  1593.      the channel is made private, etc.
  1594.  
  1595. ISON Notify
  1596.      This event occurs when AmIRC 'sees' a user that is configured in
  1597.      your 'Notify' list.
  1598.  
  1599. Connection
  1600.      This event occurs when AmIRC makes a connection to an IRC server.
  1601.  
  1602. Invite
  1603.      This event occurs when another user invites you to join a channel
  1604.      that is currently set to /MODE 'Invite Only'
  1605.  
  1606. GUI Configuration
  1607. *****************
  1608.  
  1609. GUI
  1610. ===
  1611.  
  1612. The GUI configuraton page allows you to control some specific aspects
  1613. of AmIRC that arent covered in the MUI configuration.
  1614.  
  1615. Userlist:
  1616. ---------
  1617.  
  1618. The userlist cycle gadget allows you to control if the User List is
  1619. visible or not visible, and if it is visible, if it is a separate
  1620. window, or a part of the AmIRC window.  If the Sort Gadget is check
  1621. marked, the list will be sorted alphabetically, otherwise, the list
  1622. will reflect the order that the users have joined the chat.
  1623.  
  1624. The Buttons Gadget will toggle on & off the gadgets in the User
  1625. Action List, located below the user list.  If the user list is
  1626. configured as a separate window, the buttons will also appear in that
  1627. window.
  1628.  
  1629. The Order Cycle gadget allows you to choose if you want new users
  1630. listed at the top or bottom of the user list, or to sort the list in
  1631. alphabetical order.
  1632.  
  1633. The Userlist win open? gadget will control if the userlist is open or
  1634. closed if configured as a separate window.
  1635.  
  1636. Misc
  1637. ----
  1638.  
  1639. Here you may select a different pubscreen for the query window to appear
  1640. on.  If no pubscreen is specified, the Query window will open on the
  1641. AmIRC default screen.
  1642.  
  1643. Text Colors
  1644. -----------
  1645.  
  1646. In this section, you may configure the colors that certain text will
  1647. appear in AmIRC.  These colors are based on the MUI pen colors that you
  1648. have configured in MUI.  Just click and hold on the cycle gadget to see
  1649. a list of the MUI Pen colors available.
  1650.  
  1651. Normal Text
  1652.      Text that is a normal message from a user.
  1653.  
  1654. Private Messages
  1655.      Text that is a private message from another user to you.
  1656.  
  1657. Mode Changes
  1658.      Text that shows a mode change for the channel.
  1659.  
  1660. Highlighted Text
  1661.      text that is configured in the Lists list for AmIRC.
  1662.  
  1663. Server Messages
  1664.      Text that comes from the server, i/e when a user joins or exits the
  1665.      channel.
  1666.  
  1667. CTCP/DCC Messages
  1668.      Text that informs you of an incoming CTCP or DCC request.
  1669.  
  1670. Logging
  1671. -------
  1672.  
  1673. Here you may enter the path & name to use for the logfile.
  1674.  
  1675. "Lists..." Menu Item
  1676. ********************
  1677.  
  1678. Lists Configuration
  1679. ===================
  1680.  
  1681. Alias Tab
  1682. ---------
  1683.  
  1684. Here you can create aliases, or shortcuts for complex IRC commands.
  1685. Some examples have been created for you, and a reference template
  1686. appears at the bottom of this page. %p is the place holder for any
  1687. arguments you may wish to add when using an alias.
  1688.  
  1689. Ignore Tab
  1690. ----------
  1691.  
  1692. Here you can set which users if any you want to ignore, and what kind of
  1693. messages from them to ignore.  To add an ignore to the list, click the
  1694. 'Add Ignore' gadget, then type the user's name in the text input gadget
  1695. labeled 'Ignore'.  Next click on the type of messages you want to
  1696. ignore. Checking the 'text' box will prevent you from seeing any public
  1697. messages from the user.  Setting the 'privmsgs' box will prevent you
  1698. from seeing /MSGs from that user to you.  Likewise, clicking the
  1699. 'CTCPs' box will prevent you from seeing any CTCP requests from the
  1700. Ignored user.  To delete an ignore, click on the entry you wish to
  1701. delete, and then click on the 'delete ignore' gadget.
  1702.  
  1703. Hilite Tab
  1704. ----------
  1705.  
  1706. Here you may set certain text to be highlighted in order to get your
  1707. attention if that text appears.  You may set text to match the nick,
  1708. Userhost, or any keyword enclosed in double quotes. To add a new
  1709. pattern, click on the Button labeled "Add new Hilite pattern", and type
  1710. your pattern into the input gadget.  To delete an existing pattern,
  1711. Click on the entry yo uwish to delete and then click on the button
  1712. labeled "Delete Hilite pattern".  The Hilite patterns will ignore a
  1713. pattern it recognizes if it was input by you, but will activate on the
  1714. pattern from other users.
  1715.  
  1716. Pattern Definitions:
  1717. --------------------
  1718.  
  1719. Nick
  1720.      This will watch the AmIRC listview for the nick that you specify,
  1721.      and highlight the text for that users message.  The 'Nick' entry
  1722.      does not require double quotes.
  1723.  
  1724. Userhost
  1725.      This will watch for messages that originate from a particular
  1726.      Userhost, and highlight the text for that message. Userhost
  1727.      entries may contain wildcards.  Examples:
  1728.  
  1729.     fred!fdoe@doe1.powernet.edu
  1730.           This will highlight only messages from fred at that
  1731.           particular address.
  1732.  
  1733.     fred!*@*
  1734.           This will highlight messages from anyone named fred,
  1735.           regardless of address or login name.
  1736.  
  1737.     Fred!*@*.powernet.edu
  1738.           This will highlight messages from anyone named fred on any
  1739.           machine on powernet.edu
  1740.  
  1741.     *!*@doe1.powernet.edu
  1742.           This will highlight any messages from anyone on the doe1
  1743.           machine at powernet.edu
  1744.  
  1745.     *!*@*
  1746.           This will highlight any messages from any user.
  1747.  
  1748. "Keyword"
  1749.      This will highlight any message that contains the text enclosed in
  1750.      double quotes.
  1751.  
  1752. Function Key Definitions
  1753. ************************
  1754.  
  1755. Function Keys
  1756. =============
  1757.  
  1758. Here you may define the Amiga's ten functon keys to insert text into
  1759. the input string gadget of AmIRC. By using the keys normally, or with
  1760. the 'shift' or 'crtl' modifiers, you may define up to 30 text input
  1761. macros that can be used at the press of a key. This is similar to the
  1762. functon key macros found on many popular terminal emulation programs.
  1763.  
  1764. A /n at the end of a function key definition will send a <CR> after
  1765. the text.  The function key definitions also allow placeholders,
  1766. similar to the Operation.
  1767.  
  1768. AmIRC's ARexx Port
  1769. ******************
  1770.  
  1771. Overview
  1772. ========
  1773.  
  1774. AmIRC supports a versatile ARexx Port.
  1775.  
  1776. Reference
  1777. =========
  1778.  
  1779. SAY
  1780. ---
  1781.  
  1782. Usage: SAY TEXT/F
  1783.  
  1784. DESCRIPTION:
  1785.  
  1786. Treats TEXT just like it has been entered in the string gadget of the
  1787. current window.
  1788.  
  1789. EXAMPLES:
  1790.  
  1791.     say '/JOIN #Amigager'
  1792.  
  1793. RELATED TOPICS: See RX_ECHO.
  1794.  
  1795. ISCONNECTED
  1796. -----------
  1797.  
  1798. Usage: ISCONNECTED
  1799.  
  1800. DESCRIPTION:
  1801.  
  1802. Checks whether a connection is currently established. Returns RC 0 if
  1803. the link is up, RC 5 otherwise.
  1804.  
  1805. EXAMPLES:
  1806.  
  1807.     ISCONNECTED; say rc
  1808.  
  1809. RELATED TOPICS:
  1810.  
  1811. GETMYNICK
  1812. ---------
  1813.  
  1814. Usage: GETMYNICK
  1815.  
  1816. DESCRIPTION:
  1817.  
  1818. Returns your current nickname.
  1819.  
  1820. EXAMPLES:
  1821.  
  1822.     GETMYNICK; say result
  1823.  
  1824. RELATED TOPICS: See RX_GETSERVERNAME.
  1825.  
  1826. GETSERVERNAME
  1827. -------------
  1828.  
  1829. Usage: GETSERVERNAME
  1830.  
  1831. DESCRIPTION:
  1832.  
  1833. Returns the name of the IRC server you are currently connected to.
  1834.  
  1835. EXAMPLES:
  1836.  
  1837.     GETSERVERNAME; say result
  1838.  
  1839. RELATED TOPICS: See RX_GETMYNICK.
  1840.  
  1841. USERHOST
  1842. --------
  1843.  
  1844. Usage: USERHOST NICK/A
  1845.  
  1846. DESCRIPTION:
  1847.  
  1848. Returns the userhost specification belonging to NICK.
  1849. AMIRC keeps a internal list of the userhosts of every nick that occured
  1850. yet. You can query this database with this command.  Note however that
  1851. it is possible that the userhost isn't in the database yet; this
  1852. command will not query the server than, but simply return an error.
  1853.  
  1854. EXAMPLES:
  1855.  
  1856.     USERHOST Olli; say result
  1857.  
  1858. RELATED TOPICS: See RX_GETMYNICK.
  1859.  
  1860. ECHO
  1861. ----
  1862.  
  1863. Usage: ECHO P=PREFIX/K, TEXT/F
  1864.  
  1865. DESCRIPTION:
  1866.  
  1867. Sends text to the listview
  1868.  
  1869. EXAMPLES:
  1870.  
  1871.     ECHO P=Kewlja This is echo test
  1872.  
  1873. RAW
  1874. ---
  1875.  
  1876. Usage: RAW TEXT/F
  1877.  
  1878. DESCRIPTION:
  1879.  
  1880. Sends text to the server in raw format.
  1881.  
  1882. EXAMPLES:
  1883.  
  1884.     RAW PRIVMSG phalanx: heya! whats happening?
  1885.  
  1886. CHANNELS
  1887. --------
  1888.  
  1889. Usage: CHANNELS NULL
  1890.  
  1891. DESCRIPTION:
  1892.  
  1893. Returns a list of channels currently joined in the format: "#channel1
  1894. #channel2 etc."
  1895.  
  1896. EXAMPLES:
  1897.  
  1898.     options results; channels; say result
  1899.  
  1900. GETCHANNEL
  1901. ----------
  1902.  
  1903. Usage: GETCHANNEL
  1904.  
  1905. DESCRIPTION:
  1906.  
  1907. Returns the name of the channel currently active in the format:
  1908. "#channel."
  1909.  
  1910. EXAMPLES:
  1911.  
  1912.     options results; getchannel; say result
  1913.  
  1914. RELATED TOPICS: See RX_CHANNELS.
  1915.  
  1916. GETSELECTEDUSER
  1917. ---------------
  1918.  
  1919. Usage: GETSELECTEDUSER
  1920.  
  1921. DESCRIPTION:
  1922.  
  1923. Returns the Nick the user highlighted in the userlist window.
  1924.  
  1925. EXAMPLES:
  1926.  
  1927.     options results; getselecteduser; say result
  1928.  
  1929. RELATED TOPICS: See RX_GETUSER, See RX_GETUSERS.
  1930.  
  1931. GETUSER
  1932. -------
  1933.  
  1934. Usage GETUSER /N
  1935.  
  1936. DESCRIPTION:
  1937.  
  1938. Returns the nick of the user number given on the active channel
  1939. userlist.
  1940.  
  1941. EXAMPLES:
  1942.  
  1943.     options results; getuser 1; say result
  1944.  
  1945. RELATED TOPICS: See RX_GETSELECTEDUSER, See RX_GETUSERS.
  1946.  
  1947. GETUSERS
  1948. --------
  1949.  
  1950. Usage GETUSERS
  1951.  
  1952. DESCRIPTION:
  1953.  
  1954. Returns a string containing the list of users on the active channel.
  1955.  
  1956. EXAMPLES:
  1957.  
  1958.     options results; getusers; say result
  1959.  
  1960. RELATED TOPICS: See RX_GETUSER, See RX_GETSELECTEDUSER.
  1961.  
  1962. GETUSERSTATE
  1963. ------------
  1964.  
  1965. Usage GETUSERSTATE /N
  1966.  
  1967. DESCRIPTION:
  1968.  
  1969. Returns the status of user "num" on the active channel.
  1970. RC=0 User is online, but has no special status.
  1971. RC=1 User is Channel Operator.
  1972. RC=2 User is online and has been "Voiced".
  1973. RC=5 User # not in the userlist.
  1974. EXAMPLES:
  1975.  
  1976.     options results; getuserstate 1; say rc
  1977.  
  1978. GETLINE
  1979. -------
  1980.  
  1981. Usage GETLINE
  1982.  
  1983. DESCRIPTION:
  1984.  
  1985. Waits for a line from the server and returns the following stem
  1986. variables;.
  1987. LINE        = The entire, unparsed, line recieved.
  1988. LINE.PREFIX = The Nick and user@host.
  1989. LINE.COMMAND= The MSG Type.
  1990. LINE.DEST   = The channel the message was written to.
  1991. LINE.REST   = The message text.
  1992. EXAMPLES:
  1993.  
  1994.     options results
  1995.  
  1996. getline
  1997.  
  1998. text=line prefix=line.prefix comm=line.command dest=line.dest
  1999. rest=line.rest
  2000.  
  2001. say text,prefix,comm,dest,rest
  2002.  
  2003. RELATED TOPICS: See RX_PARSELINE, See RX_GETLASTLINE.
  2004.  
  2005. GETLINECOUNT
  2006. ------------
  2007.  
  2008. Usage GETLINECOUNT
  2009.  
  2010. DESCRIPTION:
  2011.  
  2012. Returns the number of lines in the channel buffer for the active window
  2013. channel.
  2014.  
  2015. EXAMPLES:
  2016.  
  2017.     options results; getlinecount; say result
  2018.  
  2019. RELATED TOPICS: See RX_GETLINE.
  2020.  
  2021. GETLASTLINE
  2022. -----------
  2023.  
  2024. Usage GETLASTLINE
  2025.  
  2026. DESCRIPTION:
  2027.  
  2028. Returns the last private message received in the format;.
  2029. :nick!~user@host Messagetype Nick :message text.
  2030.  
  2031. EXAMPLES:
  2032.  
  2033.     options results; getlastline; say result
  2034.  
  2035. RELATED TOPICS: See RX_PARSELINE, See RX_GETLINE.
  2036.  
  2037. GETAWAYSTATE
  2038. ------------
  2039.  
  2040. Usage GETAWAYSTATE
  2041.  
  2042. DESCRIPTION:
  2043.  
  2044. Returns your away status.
  2045. rc=0 Not away.
  2046. rc=5 Away.
  2047. EXAMPLES:
  2048.  
  2049.     options results; getawaystate; say rc
  2050.  
  2051. GETVERSION
  2052. ----------
  2053.  
  2054. Usage GETUSERS
  2055.  
  2056. DESCRIPTION:
  2057.  
  2058. Returns the Version number of AmIRC.
  2059.  
  2060. EXAMPLES:
  2061.  
  2062.     options results; getversion; say result
  2063.  
  2064. PARSELINE
  2065. ---------
  2066.  
  2067. Usage PARSELINE
  2068.  
  2069. DESCRIPTION:
  2070.  
  2071. Parses the line specified and returns the following stem variables;
  2072. LINE        = The entire, unparsed, line recieved.
  2073. LINE.PREFIX = The Nick and user@host
  2074. LINE.COMMAND= The MSG Type
  2075. LINE.DEST   = The channel the message was written to.
  2076. LINE.REST   = The message text.
  2077. EXAMPLES:
  2078.  
  2079.     options results
  2080.  
  2081. getlastline last=result parseline last
  2082.  
  2083. text=line prefix=line.prefix comm=line.command dest=line.dest
  2084. rest=line.rest
  2085.  
  2086. say text,prefix,comm,dest,rest
  2087.  
  2088. RELATED TOPICS: See RX_GETLINE, See RX_GETLASTLINE.
  2089.  
  2090. Magic User Interface
  2091. ********************
  2092.  
  2093. About MUI
  2094. =========
  2095.  
  2096.  
  2097.                                This application uses
  2098.      
  2099.      
  2100.                              MUI - MagicUserInterface
  2101.      
  2102.                      (c) Copyright 1993/94 by Stefan Stuntz
  2103.      
  2104.      
  2105.                         Without MUI, AmIRC wouldn't exist.
  2106.      
  2107.      
  2108.                If you want to register directly, feel free to send
  2109.      
  2110.      
  2111.                               DM 30.-  or  US$ 20.-
  2112.      
  2113.                                        to
  2114.      
  2115.                                   Stefan Stuntz
  2116.                              Eduard-Spranger-Straße 7
  2117.                                   80935 München
  2118.                                      GERMANY
  2119.  
  2120. Why MUI?
  2121. ========
  2122.  
  2123. Why MUI? you ask...
  2124. MUI is the most powerful application framework toolkit available for any
  2125. platform.  MUI allows applications to provide their users with a highly
  2126. usable, fast and configurable user interface which works well on any
  2127. screen setting, from a 640x200 NTSC display to a 1280x1024 true color
  2128. graphics board.  MUI applications use less memory than comparable
  2129. applications since they can rely on a huge set of shared class code,
  2130. which is especially true if several MUI apps are run on the same
  2131. machine.
  2132.  
  2133. Plus, MUI's powerful OO class methods allows the application programmer
  2134. to work on the program's functionality instead of doing repetitive low
  2135. level tasks, resulting in much more powerful applications given the same
  2136. development times.  MUI's GUI classes overcome the severe design bugs in
  2137. the ROM internal BOOPSI gadget classes, allowing for complex GUI objects
  2138. without high priority CPU hogging or potential system deadlocks.
  2139.  
  2140. MUI compacts over 4 years of development and optimization in a powerful
  2141. toolkit, an effort no application programmer can afford to invest in his
  2142. own development.
  2143.  
  2144. Those Deserving Favour
  2145. **********************
  2146.  
  2147. Thanks to::
  2148. ===========
  2149.  
  2150. The author wishes to thank the following people for their help during
  2151. AmIRC development:
  2152.  
  2153. Karl 'Phalanx' Bellve
  2154.      Who provides space, connectivity and cpu time for running the
  2155.      AmIRC support area.  He also helped during development, and did
  2156.      alot of encouragement. :-)
  2157.  
  2158. Laurence 'DuRaN' Walton
  2159.      Who did write the documentation, first installer and also helped
  2160.      alot during development in other respects.
  2161.  
  2162. Christopher 'ChrisDi' Dietz
  2163.      Who did the German catalog translation.
  2164.  
  2165. Philippe 'PhB' Brand
  2166.      Who did the french catalog translation.
  2167.  
  2168. Fredrik Rambris
  2169.      Who did the swedish catalog translation.
  2170.  
  2171. Pascal 'arcade' Eeftinck
  2172.      Who did the dutch catalog translation.
  2173.  
  2174. Juan 'Goliath' Ramirez
  2175.      Who did the Spanish translation
  2176.  
  2177. Manuel 'CCCP' Giorgini
  2178.      Who did the Italian translation
  2179.  
  2180. Troy 'Doogie' Davis
  2181.      Who helped much with testing and developing the ARexx port, besides
  2182.      reporting bugs and making useful suggestions of other kinds.
  2183.  
  2184. Robert 'RobR' Reiswig
  2185.      Who did write the installer script.
  2186.  
  2187. Mike 'Mike' Fitzgerald
  2188.      for writing the ARexx Section of the docs
  2189.  
  2190. Olaf 'Olsen' Barthel
  2191. Michael 'mlelstv' van Elst
  2192. Kenneth 'Kenneth' Jennings
  2193. David 'Deathland' Zvekic
  2194.      for their help with debugging the as225r2 code.
  2195.  
  2196. Klaus 'kmel' Melchior
  2197.      for his help with tracking down several MLink problems.
  2198.  
  2199. Andreas M. 'bonzo' Kirchwitz
  2200.      for useful advice and showing a good load of humor during the
  2201.      //KICKBAN test.
  2202.  
  2203. Ralph 'rbabel' Babel
  2204.      who helped to track down a nasty bug in slink's constructor
  2205.      priority ordering.
  2206.  
  2207. The SAS/C Amiga Development team
  2208. (Especially Steve Krueger)
  2209.      For their continued support of teh SAS/C Compiler
  2210.  
  2211. Holger 'hkr' Kruse
  2212.      who pointed out the easy solution to the WTF is my own IP
  2213.      number? problem
  2214.  
  2215. Jason 'morden' Murray
  2216. Robert 'Devo' Bradman
  2217.      who drew the OP and VOICE icons
  2218.  
  2219. Angela 'Nessy' Schmidt
  2220. Christoph 'Pepo' Feck
  2221. Sascha 'Master' Lentz
  2222.      who helped test several AmIRC features in a real-life environment
  2223.      (say #AmigaGER ;-)
  2224.  
  2225. The IRC admin at irc.uni-paderborn.de
  2226. (Thomas 'Heager' Thissen)
  2227.      which served as the primary test site
  2228.  
  2229. Brian 'SmknDHerb' Maurino
  2230. Sandro 'Sandro' Catallo
  2231. Robert 'Gostrider' Wilkins
  2232.      Who created and compiled the demo sounds
  2233.  
  2234. Fionn 'Fionn' Behrens
  2235. Frank 'Daddie' Peters
  2236. Holger 'Heureka' Jakob
  2237. Jens 'Jens' Hünerberg
  2238. Mathias 'Merlin' Mischler
  2239. Michael 'mickh' Hohmann
  2240. Nicole 'Talyn' Brandt
  2241. Peter 'Stoebi' Schulz
  2242. Roy 'AK' Millican
  2243. Thomas 'logo' Butter
  2244.      for early testing and design suggestions
  2245.  
  2246. Christoph 'CeeGee' Gülicher
  2247. Danny 'Danny' Amor
  2248. Markus 'Ill' Illenseer
  2249. Markus 'Lammy' Lamers
  2250. Matthias 'DrMabuse' Lühr
  2251.      who simply bugged me to get on the list :)
  2252.  
  2253. Osma 'Tau' Ahvenlampi
  2254.      The major inspiration for the IGNORE support in AmIRC
  2255.  
  2256. This Document Prepared by Laurence Walton
  2257.  
  2258. ©1995 Oliver Wagner
  2259. All Rights Reserved
  2260.  
  2261. How to Report Bugs
  2262. ******************
  2263.  
  2264. Bug Reports
  2265. ===========
  2266.  
  2267.  
  2268.      Please send bug reports to AmIRC@lsd.wupper.de, not to my
  2269.      standard mailbox.  Include in the report the OS version of your
  2270.      amiga, The version of MUI that you have installed, and the version
  2271.      of AmIRC that you are using.
  2272.      
  2273.      Problems or additions of the AmIRC documentation should be directed to:
  2274.      
  2275.      lww@pgh.net
  2276.  
  2277. Problems, Causes, & Cures
  2278. *************************
  2279.  
  2280. Known Bugs
  2281. ==========
  2282.  
  2283.    * You absolutely MUST install SetPatch 40.16 (or higher), otherwise
  2284.      you will stumble over the broken pool functions in 3.0/3.1 exec
  2285.  
  2286.    * The main window sometimes doesn't refresh properly when
  2287.      SIMPLE_REFRESH is used.  Known bug in MUI 2.3's listview refresh
  2288.      sometimes throwing away damage regions.  Fixed in MUI 3.
  2289.  
  2290.    * Lockup when using Magic Menu. Install NewObtainGIRPort to cure
  2291.      this.  NewObtainGIRPort is available from aminet or from the AmIRC
  2292.      home page.  In older readme's, I suggested using SafeGIRPort, but
  2293.      there were reports that this won't really help the problem. Sorry,
  2294.      I don't use Cycle2Menu or MagicMenu and never had any problems
  2295.      with this myself.
  2296.  
  2297.    * There are various problems when using AmIRC as a CLChat (ArcNet)
  2298.      client.  These are all caused by bugs within CLChatIRCD and can't
  2299.      be fixed on AmIRC's side.
  2300.  
  2301.    * ALT-CURSOR-UP/DOWN doesn't work with MultiCX. MultiCX's "advanced
  2302.      Edithook" will eat Cursor-UP/Down-Inputevent on it's own so they
  2303.      can't be processed by AmIRC. Use a different edit hook.
  2304.  
  2305.    * ZFREQ causes AmIRC to fail upon start. ZFREQ seems to be unable to
  2306.      bear an application allocating a real huge number of
  2307.      ASL_Filerequest structures. Use a different file requester patch.
  2308.  
  2309.    * Neither HILITE nor URL-Grabber work on text written by yourself.
  2310.      This is due to internal reasons, I'm not sure if it is worth
  2311.      changing.
  2312.  
  2313. How to Get Help & Updates
  2314. *************************
  2315.  
  2316. One Click Updates
  2317. =================
  2318.  
  2319. You can easily download the latest version of AmIRC from the official
  2320. AmIRC support site by choosing the 'About...' Menu item from the
  2321. 'AmIRC' menu. Here you will Find a gadget Labeled 'Download Latest
  2322. version of AmIRC'.  By clicking this gadget, AmIRC will check the
  2323. support site for the version of AmIRC there. If it is newer than the
  2324. version you are using, it will proceed to download it for you. If it is
  2325. the same version, you will be notified of this, and the download will
  2326. be aborted.  Once the new archive has been downloaded, You will be
  2327. shown the latest 'AmIRC.readme', and you will be given the option of
  2328. unarchiving the release to ram. NOTE: You must have LHA in your c:
  2329. directory for this functon to operate.  Once you have done this, just
  2330. overwrite the old AmIRC files with the new ones. Your configuraton
  2331. files will remain unchanged.
  2332.  
  2333.     NOTE: The auto update will only download a stripped version of the
  2334. archives, because this assumes you have already installed the full
  2335. version of AmIRC.  with auto update, you will receive the executables
  2336. and any updated documents.
  2337.  
  2338. Support
  2339. =======
  2340.  
  2341.     AmIRC Support Mailing List
  2342.  
  2343.      To keep up to date on AmIRC improvements or to get answers to AmIRC
  2344.      problems, Join the AmIRC support mailing list by sending email to:
  2345.      
  2346.      AmIRC-Request@lsd.wupper.de
  2347.      with the text "Add" in the body.
  2348.      
  2349.      
  2350.      AmIRC FTP Support Site
  2351.      
  2352.      For AmIRC Updates & Patches, ftp to:
  2353.      
  2354.      ftp.vapor.com/support/amirc/
  2355.      
  2356.      AmIRC Support on the World Wide Web
  2357.      
  2358.      Or, Alternatively, Visit the AmIRC WWW Support Site at:
  2359.      
  2360.      http://www.vapor.com/support/amirc/
  2361.  
  2362. Index
  2363. *****
  2364.  
  2365.  
  2366.  
  2367.  #amiga                                 IRC
  2368.  Actions Options                        Actions
  2369.  Aliases, setting up                    Lists
  2370.  AmIRC Menu                             AmIRC
  2371.  AmIRC Support                          AmIRC Support
  2372.  ARexx Menu                             Rexx
  2373.  ARexx Reference                        ARexx
  2374.  Away, Setting                          AWAY
  2375.  Bugs, Known                            Known Bugs
  2376.  Bugs, Reporting                        Bug Reports
  2377.  Channel Modes, changing                MODE
  2378.  Commands                               Commands
  2379.  Configuration Options                  AmIRC Setup
  2380.  Configuration with MUI                 MUI Preferences
  2381.  Configuring AmIRC                      Configuration
  2382.  Connecting to an IRC server            Connecting
  2383.  Contents, Table of                     Top
  2384.  Copyright Information                  Copyright
  2385.  Credits                                Credits
  2386.  CTCP                                   CTCP
  2387.  DCC                                    DCC
  2388.  Events Options                         Events
  2389.  Features Of AmIRC                      Features
  2390.  Function Keys, Setting up              Function Keys
  2391.  GUI Options                            GUI
  2392.  Hilighting certain text                Lists
  2393.  Igoring Users                          Lists
  2394.  Installing AmIRC                       Installation
  2395.  Inviting a user to a channel           INVITE
  2396.  IRC                                    IRC
  2397.  IRC Terminology                        IRC Terms
  2398.  Joining a channel                      JOIN
  2399.  Kicking a user from a channel          KICK
  2400.  Known Bugs                             Known Bugs
  2401.  Leaving a channel                      LEAVE
  2402.  LIsting Channels                       LIST
  2403.  Listing names on IRC                   NAMES
  2404.  Listing Users on a server              USERS
  2405.  Lists Menu                             Lists
  2406.  Logging Channel Text                   LOG
  2407.  Menus                                  Menus
  2408.  Messages options                       Messages
  2409.  MUI Configuration                      MUI Preferences
  2410.  MUI, About                             About MUI
  2411.  Net Etiquette                          IRC
  2412.  Nickname, Changing                     NICK
  2413.  Nickname, Setting                      NICK
  2414.  Notice, Sending                        NOTICE
  2415.  Operating AmIRC                        Operation
  2416.  Pattern matching of users              WHO
  2417.  Private message, sending               MSG
  2418.  Quitting IRC                           QUIT
  2419.  Raw text, sending                      RAW
  2420.  Registering AmIRC                      Registration
  2421.  Reporting Bugs                         Bug Reports
  2422.  Requirements for running AmIRC         Requirements
  2423.  Settings Menu                          Settings
  2424.  Settings menu: Actions                 Actions
  2425.  Settings Menu: Events                  Events
  2426.  Settings Menu: GUI                     GUI
  2427.  Settings Menu: Messages                Messages
  2428.  Support for AmIRC users                AmIRC Support
  2429.  Thanks to...                           Credits
  2430.  Time, getting server's                 TIME
  2431.  Topic, Changing the                    TOPIC
  2432.  User Modes Menu                        User Modes
  2433.  User's, finding more info on           WHOIS
  2434.  User, checking if on                   ISON
  2435.  Userhost, finding a user's             USERHOST
  2436.  Version, server's software             VERSION
  2437.  What is IRC                            IRC
  2438.  Who Was User                           WHOWAS
  2439.  Windows Menu                           Windows
  2440.  
  2441.